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FIG. 4 



public 



ava.lang. Object hookClass ( 
ava.lang. String classname, 



ava.lang. String 
ava.lang. String 
ava.lang. String 



■402 
^404 



methods, 
superclasses 
superinterfaces. 



406 



•408 



HOO 



ava.lang. StringBuffer getHookArg) 



410 



FIG. 5 



public int hookMethodI 

ava.lang. Object classcontext. 
ava.lang. String classname. 
ava.lang. String methodname, 
ava.lang. String (] superinterfaces. 
ava.lang. StringBuffer defHethodArg) 



^502 
504 
506 



public static final 
public static final 
public static final 
public static final 
public static final 
public static final 



int OO.NOT.HOOK, 
int HOOK.NO.ARGS,^ 
int HOQK.WITH.ARGSi- 
int HOOK.WITH.ARGli- 
int HG0K.WITH.ARGl_2i 
int H00K.WITH.ARG2i 
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CREATE HookControl OBJECT 



FIG, 6A 



604 



606 



608- 



612- 



OPEN CLASS FILE/ARCHIVE 



GATHER INFORMATION 
ABOUT CLASS 



SEND CLASS INFORMATION 
TO HookControl OBJECT 
(hookClass METHOD) 




STORE CLASS CONTEXT AND 
INFORMATION TO BE PASSED TO 
getHook (HOOK LOADER) 




620 



NEXT CLASS 




624 



CREATE A <clinit> 
(CLASS INITIALIZATION) 
METHOD CONTAINING 
A "RETURN" 
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FIG. 6B 



GATHER INFORMATION 
ABOUT METHOD 



■B30 




SEND METHOD INFORMATION 
TO HookControl OBJECT 
(hookMethod METHOD) 



ANSWER INCLUDES "HOW", 
i.e. WHETHER TO ALSO 
REPORT ARGUMENTS OF 
THE METHOD 



• RENAME THE METHOD 

• CREATE A NEW WRAPPER 
METHOD HAVING A TRY- 
CATCH BLOCK CONTAINING 
CALLS TO INSTRUMENTATION 
METHODS AND TO ORIGINAL 

(NOW RENAMED) METHOD 
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YES ^838 



INSTRUMENT THE METHOD 
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INSERT BYTECODES TO CALL 
getHook METHOD (i.e. BEGINING 

OF CLASS LOAD HOOK METHOD) 



■644 



INSERT BYTECODES TO STORE 
A REFERENCE TO ExecCallback 
OBJECT (RETURNED BY getHook) 
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MARK CLASS AS MODIFIED 
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VERSION STRING) 
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MARK CONSTANT POOL 
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FIG. 7 

public TradeResult buylString string, int i) 

Object object; ^'^^ 

Throwable throwablej yjg 

TradeResult tradeResult i 
'34^ if ($BIP$hook - null) 
„p $BIP$lnstallHook(), f'^'^ 

'^^^ object=$BIP$hook.inethodEntry($BIP$ref.C.$BIP$ref.M0.this.2), 
730^f (object!=null) ^j^^ 

$BIP|hook . r epor t Arg ( ob i ect . $BIP$ref .C . $BIP$ref .MO . 1. str i ng) : 
^ $BIP$hook.re^ortArg(ob)ect.$BIP$ref.C.$BIP$ref.M0.2.i)i 

'"1 tradeResult = $BIP$buy(string. i), 

I > ^ — y — ' 
catch (Throwable throwable) 712 

$BIP$hook . methodExdeption(ob ject .$BIP$ref .C . $BIP$ref .MO . throwable) i 
throw throwable; 

732x.if (obiecthnull) /^^^ 

$BIP$hook . ne thodExi t ( ob j ect . $BIP$ref .C . $BIP$ref .MO . tradeResult) ■. 
return tradeResult; 

> ^724 V722 

private TradeResult $BIP$buy (String string. int i) [-701 
Original, unmodified conents of buy 
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STORE A REFERENCE TO RETURN 
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INSERT BYTECODES TO TEST 
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(i.e. methodEntry OBJECT) AND 
(IF NULL) SKIP NEXT BYTECODES 



818- 





NO 


\ 


INSERT BYTECODES TO CALL 
reportArg METHOD FOR 
EACH ARGUMENT (LOOP) 






INSERT BYTECODES TO START 
EXCEPTION SCOPE (i.e. BEGINNING 
OF A TRY-CATCH BLOCK) 
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820 
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CALL RENAMED METHOD 



•822 




INSERT BYTECODES TO 
END EXCEPTION SCOPE 
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INSERT BYTECODES TO 
STORE RETURN VALUE 
IN LOCAL STORAGE 



•828 



INSERT BYTECODES TO 

TEST (iiethodEntry 
OBJECT AND (IF NULL) 
SKIP NEXT BYTECODES 



•830 



INSERT BYTECODES TO 
CALL methodExit METHOD 
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838 



INSERT BYTECODES TO 
LOAD SAVED RETURN VALUE 

FROM LOCAL STORAGE 



INSERT BYTECODES 
TO RETURN 




INSERT BYTECODES TO 
RETURN. BASED ON TYPE 
OF RETURN VALUE 
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CREATE STRUCTURES TO DESCRIBE 
TRY-CATCH EXCEPTION BLOCK 
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INSERT BYTECODES TO SAVE EXCEPTION 
OBJECT TO LOCAL STORAGE (i.e. 
BEGINING OF EXCEPTION HANDLER) 



846 



INSERT BYTECODES TO CALL 
methodExceptlon HETHOD 



INSERT BYTECODES TO 
LOAD EXCEPTION OBJECT 



■850 



INSERT BYTECODES TO THROW 
AN EXCEPTION 



■852 



SET METHOD'S NUMBER OF LOCAL 
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TAGS METHOD AS GENERATED BY BIP 
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FIG. 9 

public java.lang. Object classLoadStart ( ^ 1 
Java. lang. String classname, ^^^^ I ^ 
leva .lang .class classOb j . -v nni i 
int (nethods)-^ggg 

public Java. lang. Object defMethod I qpp 

ava. lang. Object classref,-^ nn^ 1 
ava Jang, String methodname. -^^^^ r^^^ 
ava. lang. String methodkind) -\.g2g 

public void classLoadEnd( 042 \qa(\ 

java . lang.Ob ject classref I j 



FIG. 10 

public Java. lang. Object methodEntry ( ^ 

Java. lang. Object classref. -^^r^L 

J ava . lang . Ob J ect methodref , ^^^^ y lOOO 

java. lang. Object instance. 



int args)- 



•lOOB 



1006 



public void reportArg ( ^102? 

java. lang. Object context,--^ -mpi 

Java. lang. Object classref ,-^'^",7.^^ I i^on 

java. lang. Object methodref . -^^''^B MU^u 

int argNumber,— --102B 

java . lang .Ob ject methodArgl-v ^930 

public void methodExit ( jAin 

Java. lang. Ob ject context.-^ 

; ava , lang .Ob ject classref . ^ ^^,^1^ > 1040 

• ava . lang .Ob ject methodref , 

ava. lang, Object result) •x.jQ4g 
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public 



FIG. 11 

ava . lang .Ob ject (nethodEntryOneArg ( 

ava.lang. Object classref , 

ava, lang. Object methodref . MlOO 

ava. lang. Object instance, -inn 

ava . lang .Ob]ect selectedArg)-^ J 



public void methodException ( 

java. lang. Object context. 
Java. lang. Ob 
Java. lang. Ob 
Java. lang. Throwable e)'^^j^22 



ect classref, ^1120 
ect methodref, 



FIG. 12 

public static ExecCallback aetHook ( ^po? 

Java .lang . String className ^pQ^ 

ava . lang . String classKind .-^ fpQr LpnA 

ava . lang .Stri ng className .-^ ipoo 

ava. lang. String classVersion.-^ ipin 

ava. lang. String interface Version)-^ 
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// $SourcG: /datal/nebula/ccfli/)ade/ccin/iinport/arra_jlink/i2/bip/hook/RCS/NullExec?Call^^^ $ 
// SRevision: 1.8 $ $Date: 2001/08/28 14:56:29 $ SAuthor: arav $ 
package i2.bip.hook: 

I** An implementation of the ExecCallback that does nothing. 
« A suitable base class for a custom hook class. 
»/ 

public class NullExecCallback 

// Explicit DoNotHook for BIC testing 
implements ExecCallback, DoNotHook ( 

// Called at start of class initialization 
// Returns opaque class ref 

public Object classLoadStart (String classname. Class classObj. int methods) 
return nullj 

} 

// Called once for each instrumented method in the class. 
// Returns opaoue method ref 
public Object defMethodI 

Object classref. 

String methodname. 

String methodkind) 

{ 

return nulls 

} 

// End of class initialization instrumentation 
public void classLoadEndlObject classref) { } 

// Called at instrumented method entry. 



publ 
Ob 
Ob 



c Object methodEntryl 
ect classref. 
ect methodref, 
ect instance, 
args) 



int 

{ 

^ return nullj // Disables methodExit S reportArg instrumentation 
// Called at instrumented method entry when single arg requested. 
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public Object diethodEntryOneArgl 

Ob]ect classref, 

Ob ect methodref. 

Object instance. 
^ Object selectedArgl 

^ return null? // Disables methodExit S reportArg instrumentation 

public Object methodEntryOneTwoArgl 

Object classref. 

Object methodref, 

Object instance. 

Object argl, 
^ Object arg2) 

^ return null; // Disables methodExit S reportArg instrumentation 

// Called at normal instrumented method exit. 
// unless returned methodEntry context is null, 
public void methodExit ( 

Object context, 

Object classref, 

Object methodref, 

Object result) { } 

// Overloaded versions of methodExit for primitive return types, 
public void methodExit! 



ect classref. 
ect methodref, 

result) { ) // Covers boolean, byte. char, short, and int 



Object context. 
Ob 
Ob 
in 

public void methodExit ( 
ect context, 
ect classref, 
ect methodref, 
float result) { } 
public void methodExit! 
Object context. 
Object classref. 
Object methodref, 



Ob] 

Ob 

Ob 
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long result) { } 
public void methodExltl 

Object context. 

Object classref, 

Object methodref, 

double result) { } 
public void methodExltl 

Object context, 

Object classref. 

Object methodref) { } 

// Called unconditionally at method exception 
public void methodExceptlonI 

Object context, 

Object classref, 

Object methodref. 

Throwable e) { } 

// 

// Argument reporting 

// Called after Instrumented method entry, once per arg. If 
// argument reporting was instrumented, 
public void reportArgI 

Ob* ' 

Ob 

Ob 

in 

Ob 

{ 
} 



ect context, 
ect classref. 
ect methodref, 

argNumber, // starts at 1 

ect methodArg) // The actual argument (reference types) 



// Overloaded versions of reportArg for primitive types, 
public void reportArgI 



Ob 
Ob 
Ob 
in 
in 

{ 
} 



ect context, 
ect classref. 
ect methodref. 

aroNumber, // starts at 1 

meihodArg) // Covers boolean, byte, char, short, and int 
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1300 



public void reportArgI 



Ob 
Ob 
Ob 
in 



ect context, 
ect classref. 
ect (iiethodref, 
argNumber, 



float (nethodArg) 

} 

public void reportArgi 
Object context. 
Object classref. 
Object methodref. 
int argNumber. 
long (nethodArg) 

} 

public void reportArgi 
Object context. 



Ob 
Ob 
in 



ect classref, 
ect methodref, 
argNumber, 



double (nethodArg) 



// starts at 1 



// starts at 1 



// starts at 1 



} // class NullExecCallback 
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ACCESS B 

WRAP OBJECT REFERRED BY B 
SET B TO POINT TO WRAPPER OBJECT 
RETURN TO ORIGINAL CALLER 
} 



2B/28 



FIG. 28 



APPLICATION SERVER 


/ V 

if \ \ 
If 1 1 


^ V 

X 




/ 

/ 

/ 

$ f 
1 I 


1 1 
/ 1 


\ \ 




< / 
f [ 


1 1 


\ Y J 1 



FIQ. 23 



© 



T 

46 




0 



T 

48 



